package com.ittao.taoaicodeuser.service;

import com.ittao.taoaicodemodel.model.dto.user.UserQueryRequest;
import com.ittao.taoaicodemodel.model.vo.user.LoginUserVO;
import com.ittao.taoaicodemodel.model.vo.user.UserVO;
import com.mybatisflex.core.query.QueryWrapper;
import com.mybatisflex.core.service.IService;
import com.ittao.taoaicodemodel.model.entity.User;
import jakarta.servlet.http.HttpServletRequest;

import java.util.List;

/**
 * 用户 服务层。
 *
 * @author <a href="https://gitee.com/it-heima-ht">程序员 Tao</a>
 */
public interface UserService extends IService<User> {

    /**
     * 用户注册
     *
     * @param userAccount   用户账户
     * @param userPassword  用户密码
     * @param checkPassword 校验密码
     * @return 新用户 id
     */
    long userRegister(String userAccount, String userPassword, String checkPassword);

    /**
     * 用户登录
     *
     * @param userAccount  用户账户
     * @param userPassword 用户密码
     * @param request
     * @return 脱敏后的用户信息
     */
    LoginUserVO userLogin(String userAccount, String userPassword, HttpServletRequest request);

    /**
     * 获取脱敏的已登录用户信息
     *
     * @return 脱敏后的用户信息
     */
    LoginUserVO getLoginUserVO(User user);

    /**
     * 获取脱敏的已登录用户信息
     *
     * @param user 用户
     * @return 脱敏后的用户信息
     */
    UserVO getUserVO(User user);

    /**
     * 获取用户信息列表
     *
     * @param userList 用户列表
     * @return 脱敏后的用户信息列表
     */
    List<UserVO> getUserVOList(List<User> userList);

    /**
     * 获取当前登录用户
     *
     * @param request 请求
     * @return 当前登录用户
     */
    User getLoginUser(HttpServletRequest request);

    /**
     * 用户登出
     *
     * @param request 请求
     * @return 是否登出成功
     */
    boolean userLogout(HttpServletRequest request);

    /**
     * 构建查询条件
     *
     * @param userQueryRequest 用户查询请求
     * @return 查询条件
     */
    QueryWrapper getQueryWrapper(UserQueryRequest userQueryRequest);

    /**
     * 加密密码
     *
     * @param userPassword 用户密码
     * @return 加密后的密码
     */
    String getEncryptPassword(String userPassword);

    /**
     * 修改用户密码
     *
     * @param oldPassword 旧密码
     * @param newPassword 新密码
     * @param loginUser   当前登录用户
     * @return 是否修改成功
     */
    boolean updateUserPassword(String oldPassword, String newPassword, User loginUser);

    /**
     * 是否为管理员
     *
     * @param user 用户
     * @return 是否为管理员
     */
    boolean isAdmin(User user);

    /**
     * 上传图片
     *
     * @param inputSource 文件输入源
     * @param loginUser   当前登录用户
     * @return 图片地址
     */
    String uploadPicture(Object inputSource, User loginUser);
                                                                                                                                                                                       
    // ========== 防刷机制相关方法 ==========

    /**
     * 检查IP注册限制
     *
     * @param ipAddress IP地址
     * @return 是否允许注册
     */
    boolean checkIpRegistrationLimit(String ipAddress);

    /**
     * 记录用户注册信息
     *
     * @param userId    用户ID
     * @param ipAddress IP地址
     */
    void recordUserRegistration(Long userId, String ipAddress);

    /**
     * 检查AI模型调用限制
     *
     * @param userId 用户ID
     * @return 是否允许调用
     */
    boolean checkAiModelCallLimit(Long userId);

    /**
     * 记录AI模型调用
     *
     * @param userId 用户ID
     */
    void recordAiModelCall(Long userId);
}
